package com.giantlizard.cloud.mybatis.base;

import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.giantlizard.cloud.base.entity.PageQuery;

import java.util.List;

/**
 * 业务层基类
 * @author kangdongwei
 * @since 2024-07-23
 * @version 1.0
 */
public interface IBaseService<T, D> extends IService<T> {
    /**
     * 通过id获取对象
     *
     * @param id 主表Id
     * @return DTO对象
     */
    D selectById(String id) throws Exception;

    /**
     * 插入一条数据
     *
     * @param dto DTO对象
     * @return 主键
     */
    String insert(D dto) throws Exception;

    /**
     * 全量更新数据
     *
     * @param dto DTO对象
     */
    boolean update(D dto) throws Exception;

    /**
     * 部分更新数据
     *
     * @param dto DTO对象
     */
    boolean updateSelective(D dto) throws Exception;

    /**
     * 通过唯一标识删除对象
     *
     * @param id 主键
     */
    boolean deleteById(String id) throws Exception;

    /**
     * 批量删除对象
     *
     * @param ids 主键集合
     */
    boolean deleteList(List<String> ids) throws Exception;

    /**
     * 获取全部满足条件的数据
     *
     * @param dto 主键
     * @return List
     */
    List<D> query(D dto) throws Exception;

    /**
     * 简单分页查询
     *
     * @param dto 过滤条件
     * @param page 分页实体
     * @return 分页对象
     */
    IPage<D> queryByPage(D dto, PageQuery page) throws Exception;


    /**
     * 高级分页查询
     * @param dto 过滤条件
     * @param page 分页实体
     * @return 分页对象
     * @throws Exception 异常
     */
    QueryWrapper<T> createQueryWrapper(D dto, PageQuery page) throws Exception;


    /**
     * Dto转换程实体entity
     * @param dto DTO对象
     * @return 对象
     * @throws Exception 异常
     */
    T transForToEntity (D dto) throws Exception;


    /**
     * vo转换程实体entity
     * @param entity 对象
     * @return DTO对象
     * @throws Exception 异常
     */
    D transForToDto (T entity) throws Exception;

    /**
     * entity转换程dto
     * @param entityList 实体集合
     * @return DTO对象集合
     * @throws Exception 异常
     */
    List<D> transForToDto (List<T> entityList) throws Exception;

    /**
     * 转换分页
     * @param page 分页对象
     * @return 分页对象
     * @throws Exception 异常
     */
    IPage<D> transForToDtoPage (IPage<T> page) throws Exception;
}
